Superpowers for Claude Code 完整指南

一、前言：為什麼需要 Superpowers？

如果你已經用過一陣子 Claude Code，大概都遇過這些狀況：

• 一句 prompt 丟下去，Claude 直接開始改 code，結果改錯方向

• 寫完功能說「我覺得這樣可以了」，但根本沒跑測試

• 遇到 bug 不查根因，直接改 symptom，越改越亂

• 同一個錯誤反覆犯，沒辦法「教」它記住規矩

Superpowers 就是為了解決這些問題而生的。它由 Jesse Vincent（obra）開發，是一套 agentic skills framework——本質上是一組「強迫 Claude 遵守軟體工程紀律」的 skills 與 hooks。

它在 2026 年 1 月 15 日被正式收錄進 Anthropic 官方 marketplace，到 2026 年 5 月 GitHub 星數已逼近 20 萬（約 1.8 萬 forks），是這一年成長最快的開源專案之一。最新版本為 v5.1.0（2026 年 4 月底發布）。

作者 Jesse Vincent 自己這樣形容它的理念：

"Skills are what give your agents Superpowers."

"You can hand a model a book or a document or a codebase and say 'Read this. Think about it. Write down the new stuff you learned.'"

簡單說：Superpowers 不是讓 Claude 變更聰明，而是讓它變得有紀律。

二、核心理念：Brainstorm → Plan → Implement

傳統 Claude Code 的問題在於它太「熱心」——你說「幫我加個登入功能」，它馬上開始寫 code。但好的工程師不會這樣，他會先問：

• 你要 OAuth 還是 email/password？

• 要支援多裝置登入嗎？

• session 要存哪？

• 失敗的 UX 怎麼處理？

Superpowers 強制 Claude 跑這個流程：

1. Brainstorming（蘇格拉底式對話）

2. Writing Plans（產出可執行的詳細規格）

3. Executing Plans（用 subagent 分批實作）

4. TDD（紅燈 → 綠燈 → 重構）

5. Verification（用證據證明完成，不是用嘴）

每一步都有 gate（檢查點），沒過不能往下走。這是 Superpowers 最大的價值——它從架構層逼 Claude 守規矩，而不是靠你在 CLAUDE.md 裡寫「請務必跑測試」這種會被忽略的指示。

三、安裝

方法 1：官方 Marketplace（推薦）

從 2026 年 1 月起，Superpowers 已進入 Anthropic 官方 plugin marketplace，最簡單：

/plugin install superpowers@claude-plugins-official
/exit

重啟 Claude Code 後生效。

方法 2：透過 obra 自家 marketplace

如果你想拿到最新的開發版：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

方法 3：其他平台

Superpowers 是跨平台的（v5.x 起原生支援多平台，並會自動鏡像到 Codex plugin）：

驗證安裝

⚠️ 重要變更（v5.1.0）：早期那些 superpowers 專屬 slash 指令（/superpowers:brainstorm、/superpowers:write-plan、/superpowers:execute-plan）以及具名的 superpowers:code-reviewer agent 都已被完全移除。當年因為 skill 觸發機制還不穩定才需要這些指令，現在 skill 觸發已經夠可靠，不再需要手動下指令。

現在驗證安裝的方式不是看 /help，而是直接跟 Claude 講「我要做一個 X」——它會自動觸發 brainstorming skill 開始問你問題，這就是它真的開始運作的訊號。

v5.1.0 重點更新（2026 年 4 月底）

如果你之前用過舊版，這幾個變化要注意：

• 移除所有 deprecated slash 指令（/brainstorm、:write-plan、:execute-plan）——skill 觸發已夠穩定，全部改自然語言觸發

• 重寫 git worktree 相關 skill：加入環境偵測、優先使用平台原生 worktree 工具、依 provenance 自動清理

• code review 整併進自包含的 skill，改派 general-purpose subagent，不再有具名的 superpowers:code-reviewer agent

• 新增 AI agent 貢獻者準則（官方提到 PR 有高比例是 AI 生成的低品質內容而被退回）

• 擴大平台支援：OpenCode 整合更順、新增 Factory Droid，並透過 sync-to-codex-plugin 自動鏡像到 Codex plugin

• 5.0.4–5.0.7 期間：plan review 從逐段改成「整份一次審」、審查回合從 5 降到 3、零依賴的 brainstorm server 改用原生 RFC 6455 WebSocket、新增 GitHub Copilot CLI 支援

四、主要 Skills 一覽

Superpowers 的核心是它附帶的一整組 skills。

流程類（Process Skills）

品質類（Quality Skills）

協作類（Collaboration Skills）

五、實戰：完整工作流程示範

假設你要在現有的 Next.js 專案加一個「使用者匯出資料為 CSV」的功能。

Step 1：丟出需求

我要在後台加一個「匯出使用者資料為 CSV」的功能

Step 2：Brainstorming Skill 自動觸發

Claude 不會直接寫 code，而是開始問問題（一次一題）：

Q1: 是匯出全部使用者，還是支援篩選條件？
Q2: CSV 欄位要包含哪些？（敏感欄位如 email/手機要遮罩嗎？）
Q3: 預期資料量級？小於 10 萬筆可以同步生成，更大需要 background job
Q4: 權限控制——只有 admin 能匯出嗎？要記 audit log 嗎？

每答一題，Claude 會更新它對需求的理解。最後產出設計文件並要你確認。

📌 重點：這個階段你會花 10–20 分鐘，但根據 Pasquale Pillitteri 的測試，這個前期投資能省下執行階段 2–3 倍的時間。

Step 3：Writing Plans

Spec 確認後，Claude 產出 PLAN.md，類似這樣：

## Task 1: 加入 GET /api/admin/users/export endpoint
- [ ] 1.1 寫失敗測試：未授權時回 403
- [ ] 1.2 寫失敗測試：admin 呼叫回 200 + CSV header
- [ ] 1.3 實作 route handler（最小可通過測試）
- [ ] 1.4 加入 audit log
Verification: curl -H "Cookie: ..." /api/admin/users/export

## Task 2: 前端按鈕與下載
...

每個 task 都拆到 2–5 分鐘可完成的 micro-task，這是 Superpowers 的設計關鍵——任務小到不會吃光 context window。

Step 4：Executing Plans

PLAN.md 確認後，直接跟 Claude 說「開始執行這個 plan」即可（v5.1.0 已移除 /superpowers:execute-plan 指令，改由 executing-plans skill 自動接手）。

Claude 會：

• （可選）開一個 git worktree 隔離工作

• 依序執行每個 task，每個 task 內走 TDD 循環

• 每完成一批 task 就停下來等你 review

• 進度寫進 progress.md，就算 context 滿了也不會丟失

Step 5：Verification

完成後 Claude 不會說「應該可以了」，而是必須：

# 跑測試
$ npm test
✓ 24 passing

# 跑驗證指令
$ curl -H "Cookie: admin_session=..." localhost:3000/api/admin/users/export
HTTP/1.1 200 OK
Content-Type: text/csv
...

把實際輸出貼出來，你才能信。這就是 verification-before-completion skill 的價值——證據先於主張。

六、進階用法

1. Subagent 平行開發

當任務可拆成獨立部分（例如：UI、API、資料庫遷移），用 dispatching-parallel-agents：

我要重構登入流程，前端、後端 API、DB schema 三邊都要動

Claude 會同時派 3 個 subagent 進行，速度快 3–4 倍，且各 subagent 的 context 互相隔離，不會吃掉主 session 的 token。

2. 寫自己的 Skill

如果你的團隊有特定 convention（例如「所有 API 必須加 OpenTelemetry trace」），可以教給 Claude：

我要寫一個新 skill：每次寫 API endpoint 時自動加 trace

writing-skills skill 會引導你產出符合格式的 skill 檔，存進 .claude/skills/，下次就會自動觸發。

這就是 Jesse 說的："Claude and I build new skills"——這個系統是會自我成長的。

3. 配合 Git Worktree

using-git-worktrees skill 會在開始大改動前自動：

git worktree add ../myproject-feature-xyz feature/xyz
cd ../myproject-feature-xyz

讓你主分支保持乾淨，實驗失敗也好還原。

七、最佳實踐與踩坑提醒

✅ 該做的

• 大功能再用：Superpowers 是給「複雜任務」設計的，寫個 throwaway script 不要硬上

• 相信前期投資：Brainstorming 階段不要急，多問清楚比後面重做好

• 別跳過 verification：Claude 給你輸出證據時，真的去看一下，不要只看「✅ done」

• 讓 subagent 做髒活：大量讀檔、grep、研究新 library，丟給 subagent 不會吃你 context

❌ 別做的

• 不要在 brainstorm 階段催它寫 code——你會繞回原本的問題

• 不要把 Superpowers 當萬能藥——簡單的「改個 typo」用它反而慢

• 不要忽略 skill 的 Why: 與 How to apply: 欄位，那是它判斷邊界的依據

• 不要混用衝突的指示：CLAUDE.md 寫「跳過 TDD」會覆蓋 skill，按 Superpowers 的優先順序，使用者指示永遠最高

常見問題

Q：跟我自己寫的 CLAUDE.md 衝突怎麼辦？
A：使用者指示 > skills > 系統 prompt。CLAUDE.md 永遠贏。

Q：會不會變很慢？
A：單次互動會變長，但整體完成時間變短——因為少了大量「改錯方向後重做」的回合。

Q：Token 會爆嗎？
A：反而省。subagent 跟 plan/progress markdown 檔讓 context 不會無止盡膨脹。

八、結語

Superpowers 改變了我用 Claude Code 的方式。以前我會在 prompt 裡塞一堆「請務必先寫測試」「請務必查根因」「請務必確認再說完成」——現在這些都由 framework 自動 enforce。

它的核心洞察其實很簡單：LLM 不缺能力，缺的是紀律。把資深工程師的工作流程編碼成 skills，AI 自然就會表現得像資深工程師。

如果你還沒裝，現在就試試：

/plugin install superpowers@claude-plugins-official

然後跟它說一句「我要做 X」，看看它怎麼開始問你問題——你會立刻感受到差別。

參考資料

• Superpowers GitHub Repo (obra/superpowers)

• Anthropic 官方 Plugin 頁

• Jesse Vincent 原始介紹文：Superpowers - How I'm using coding agents in October 2025

• Superpowers 5.1.0 Release Notes

• Trevor Lasn：Claude Code Superpowers - How to Add Skills That Plan Before Coding

• Pasquale Pillitteri：Superpowers for Claude Code Complete Guide 2026

• Dev Genius：Superpowers explained - the popular Claude plugin that enforces TDD, subagents, and planning

• Colin McNamara：Stop Babysitting Your AI Agents - The Superpowers Breakthrough

• DEV Community (tumf)：Superpowers - The Technology to "Persuade" AI Agents

• Superpowers Marketplace Repo